通知对象
通知对象用于统一管理告警推送的目标渠道，支持企微机器人、飞书机器人、钉钉机器人、Webhook 四种类型。创建后可在通知策略中直接引用，避免同一渠道信息在多条告警规则 中重复维护。
本页仅用于维护 IM 机器人和 Webhook 等群组 / 系统通知渠道。如需维护具体人员的邮箱、手机号、企业微信 ID 等个人信息，请前往接收人管理。
快速上手
第一步：进入创建页面
进入 设置中心 → 通知对象，点击创建，进入新建通知对象页面。
第二步：填写基本信息
- 选择通知类型：企微机器人 / 飞书机器人 / 钉钉机器人 / Webhook
- 填写通知对象名称（必填，最长 50 字符）
- 填写 Webhook 地址（必填）
第三步：完成专属配置并保存
- 根据所选类型填写专属配置（如 Webhook 的请求头、成功判断规则）
- 确认启停状态（默认开启）
- 点击发送测试验证连通性，确认无误后点击保存
功能说明
通知对象列表
列表展示当前账号下所有通知对象，支持按名称、类型、启停状态进行搜索过滤；Webhook 地址过长时自动截断，鼠标悬浮可查看完整地址。
| 操作 | 说明 |
|---|---|
| 测试 | 弹出测试内容输入框，填写内容后发送，实时展示发送结果（成功 / 失败）及响应体摘要 |
| 编辑 | 修改通知对象的名称、地址及专属配置 |
| 删除 | 永久删除该通知对象，需二次确认，提示"关联的通知将无法通过此渠道推送通知，且操作不可撤销" |
| 启停状态 | 点击列表中的状态按钮可直接切换启用 / 禁用，无需进入编辑弹窗；禁用后关联的告警规则将跳过该渠道，重新启用后自动恢复 |
创建通知对象
基本信息
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 通知类型 | 是 | 支持企微机器人、飞书机器人、钉钉机器人、Webhook 四种类型，选定后不可再修改类型，如需更换建议重新创建 |
| 通知对象名称 | 是 | 通知对象的显示名称，用于在告警规则、通知策略中引用，最长 50 字符 |
| Webhook 地址 | 是 | 推送消息的目标 URL，各平台格式不同，可从对应机器人的创建后台获取 |
各类型专属配置
企微机器人
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 消息类型 | 是 | 支持文本消息、Markdown 消息 |
飞书机器人
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 签名校验密钥 | 否 | 飞书机器人开启"签名校验"安全设置时 必填，密文输入，支持点击眼睛图标临时预览，长度限制 100 字符 |
| 消息类型 | 是 | 支持纯文本、富文本、卡片消息 |
钉钉机器人
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 消息类型 | 是 | 支持文本消息、Markdown 消息、卡片消息 |
| 安全设置 | 否 | 选择加签密钥时展开密文输入框，需填写以 SEC 开头的密钥，支持点击眼睛图标预览，长度限制 100 字符 |
钉钉机器人的安全设置在此仅支持无和加签密钥两种。"自定义关键词"和"IP 白名单"需在钉钉机器人侧配置，无需在通知对象中填写。
Webhook
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 请求方法 | 固定 | 固定为POST，不可修改 |
| 请求头 | 否 | 点击添加请求头逐条添加自定义 Header，最多 10 条，Key 限 64 字符、Value 限 1024 字符；Value 右侧带眼睛图标，可切换查看/隐藏原文，编辑态默认以 •••••••• 展示 |
| HTTP 状态码 | 是 | 判断推送是否成功的规则之一，支持2xx（默认，200–299）、仅 200、自定义（手动填写允许的状态码，逗号分隔，如 200,201,204） |
| 响应体匹配 | 否 | 点击添加匹配规则，配置 JSONPath 表达式和期望值，可添加多条，多条之间取 AND 关系，最多 10 条 |
仅 HTTP 状态码正确不代表业务成功。为 Webhook 添加响应体匹配规则（如 JSONPath 填 $.errcode，期望值填 0），可识别目标系统返回的业务层错误，避免误判发送成功。
测试发送
在测试弹窗的输 入框中填写测试内容（必填，限 200 字符），点击发送后展示测试结果：
- 结果区：成功（绿色）/ 失败（红色），显示"【通知对象名称】测试消息发送成功 / 失败"
- 响应体摘要：等宽字体展示原始响应体，超出限高部分可滚动查看
成功判定逻辑为 HTTP 状态码符合规则 且 所有响应体匹配规则均满足，两者同时成立才展示为发送成功。
常见场景
场景：统一管理多个企微群机器人 为"核心服务告警群"和"基础设施告警群"分别创建企微机器人类型通知对象，消息类型选择 Markdown。后续在通知策略中直接引用对应通知对象，修改 Webhook 地址只需在通知对象页操作一次，无需逐条修改告警规则。
场景：对接外部系统并识别业务层失败
类型选择 Webhook，认证信息通过请求头传入（如 Authorization: Bearer ${token}）。成功判断规则中 HTTP 状态码选 2xx，并添加响应体匹配规则 $.code = 0。即使接口返回 200，只要响应体中 code 不为 0，也会被判定为发送失败。
场景：钉钉机器人加签校验
类型选择钉钉机器人，安全设置选择加签密钥，填写以 SEC 开头的密钥。保存后推送消息将自动携带签名，避免因钉钉群开启加签校验而导致消息被拦截。
注意事项
删除或禁用通知对象前，请确认当前没有告警规则或通知策略仍在引用它。禁用后关联的推送会被静默跳过而不会报错，容易被忽略。
删除通知对象为不可逆操作，删除后关联的通知策略将无法继续通过该渠道推送通知，请谨慎操作。